Oracle PL/SQL wrappers for Name Object on Windows

*************
INTRODUCTION
*************

This file describes how to setup and use the Oracle PL/SQL wrapper code with Melissa DATA's Name Object library.


*************
PREREQUISITES
*************

To make use of the Name Object PL/SQL Wrapper you will need:

* An installation of Oracle 11 or later.

* The Melissa DATA Name Object library and data files installed.

	Library = mdName.dll 
	Data Files = mdName.dat, mdName.cfg

These files are installed automatically if you run setup.exe installer from the DQSuite disc.

You will need to know the location of these items in order to install and execute the PL/SQL wrapper.


*************
Installation
*************

Copy the entire folder that contains this readme.txt into a local directory on your computer.
Copy the mdName.dll to the %ORACLE_HOME%\bin directory, or optionally set EXTPROC_DLLS to ANY with the Path set to the mdName.dll and restart the TNS listener.

Make sure to use the Name Object library for your architecture ie: 32/64. They can be found on the DQSuite disc at the following locations:
	\name\windows\dll_32bit
	\name\windows\dll_64bit

******
Setup
******

GRANTS:
As an ORACLE SYSADM, perform grants for create procedure, create library to the ORACLE_USER.

As the Windows user run load_wrappers.cmd from the shell to actually create the wrappers. Make sure the ORACLE_HOME variable is set correctly so that %ORACLE_HOME% gets substituted at run time.

For Example:
c:\>load_wrappers.cmd

This will load the PLS Wrapper, and convert into PL/SQL native Functions and Procedures. 

*************************
Running the Test Scripts
*************************
SINGLE RECORD TEST
1. Edit the provided example script test_mdName.sql and set the LICENSE and the PATH to the Name data files. If you do not have a License call Melissa Data at 800-800-6245 ext 3.

mdNameSetLicenseString(no, 'SET_LICENSE_HERE');
mdNameSetPathToNameFiles(no, 'SET_PATH_HERE');

Create the table to store the Object's return values.
CREATE TABLE "ORACLE_USER"."LOG" ( "VALUES" (4096))

2. From SQLPLUS execute the provided example test_mdName.sql to exercise the functionality of Name Object.

@test_mdName.sql

BATCH RECORDS TEST
1. Steps to run the batch example. If you have not imported the data already, create a table and load the test data. For example:

CREATE TABLE "ORACLE_USER"."MD_APNE_TABLE" ( "FULLNAME" CHAR(30), "COMPANY" CHAR(50), "ADDRESS1" CHAR(50), "ADDRESS2" CHAR(50), "CITY" CHAR(30), "STATE" CHAR(10), "ZIP" CHAR(10), "EMAILADDRESS" CHAR(75), "PHONE" CHAR(20))

2. Next import the AddressPhoneNameEmail.csv into an Oracle Table using the provided APNE.ctl, SQLLDR control file. For example:

sqlldr control=APNE.ctl userid=ORACLE_USER/PASSWD

3. Execute the name_batch.sql to process the Name records in the table.  For example:

@name_batch.sql

If you should have any questions, suggestions or improvements, please email Support at g-dqt@melissadata.com.

COPYRIGHT NOTICE
(C) 2012 Melissa Data Corporation. All rights reserved.




